home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr18 / cisbl203.zip / CISBILL.DOC < prev    next >
Text File  |  1993-04-27  |  16KB  |  390 lines
  1.                              CISBILL  v2.03                  May '93
  2.                        Copyright 1993 JN Goodale
  3.  
  4.               
  5.               
  6.                        D O C U M E N T A T I O N              
  7.               
  8.               
  9.               
  10.                            _______
  11.                       ____|__     |                (R)
  12.                    --|       |    |-------------------
  13.                      |   ____|__  |  Association of
  14.                      |  |       |_|  Shareware
  15.                      |__|   o   |    Professionals
  16.                    -----|   |   |---------------------
  17.                         |___|___|    MEMBER
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                  
  27.                                  CONTENTS                 Page
  28.  
  29.                  I     Requirements and Limitations .......  1 
  30.                 II     Main Menu ..........................  1 
  31.                III     Set Up .............................  2 
  32.                 IV     Field Definitions ..................  2
  33.                  V     Files ..............................  3
  34.                 VI     Error Messages .....................  4
  35.                VII     Capturing a Billing File ...........  5
  36.               VIII     Support ............................  7
  37.                 IX     Sharware Concept/Ombudsman .........  8
  38.  
  39.                                                       CISBILL 2.03  Page  1
  40.  
  41.      I  REQUIREMENTS AND LIMITATIONS
  42.  
  43.      Requires: IBM compatible               If you are using this, you
  44.                256 K memory                  probably have a modem.
  45.                Hard Drive                    However, a modem is NOT
  46.                DOS 3.0 or above              needed to run CISBILL, because
  47.                Printer - optional            it does NOT get the billing
  48.                                              from CIS for you.
  49.  
  50.                BILLING.CAP, a captured file from a CIS billing inquiry. 
  51.                For a sample of what this is, and instructions on how to 
  52.                get it, see the section on CAPTURING A BILLING FILE.
  53.  
  54.      Limits:   Will handle up to approximately 1500 records in 256 K -
  55.                6500 in 640 K, depending on your system.  One record is 
  56.                one logon session.  1500 records would amount to about 
  57.                4 sessions per day, 365 days per year.  6500 is the max.
  58.  
  59.  
  60.      II  MAIN MENU
  61.  
  62.          After processing existing files (if any) the Main Menu will appear:
  63.  
  64.          _____________Main Menu_______________   ________Sub Menu_______    
  65.         |                                     | |                       |
  66.         |   Select Year  <OR>  One of Below   | |    Options for YYYY   |
  67.         |                                     | |                       |
  68.         |     1993               ....Quit.... | |       View Records    |
  69.         |     1992                   Help     | |       Print Weekly    |
  70.         |     1991                  Set Up    | |       Print Detail    |
  71.         |     1990                REGISTER!!  | |       Main Menu       |
  72.         |                                     | |                       |
  73.         |_____________________________________| |_______________________|   
  74.  
  75.         Select one of the options using the arrow keys.  Up to four years   
  76.         may be listed.  If 4 years are not available, subsequent entries
  77.         will appear as ".............".
  78.  
  79.         [ Help ] ....... displays a quick description of the fields.
  80.         [ Set Up ] ..... is described in the next section, SET UP.
  81.         [ REGISTER ] ... allows you to fill in the program registration from 
  82.         within the program.
  83.  
  84.         [ View ] .......... will list by week on the left of the display.  
  85.         You maythen select a week, and the details for the selected week 
  86.         will display on the right side of the display.
  87.         [ Print Weekly ] .. prints (to a file or printer) the Weekly totals.
  88.         [ Print Detail ] .. prints (to a file or printer) all records.
  89.         [ Main Menu ] ..... returns to the Main Menu.
  90.  
  91.                                                       CISBILL 2.03   Page  2
  92.  
  93.      III  SET UP
  94.  
  95.         [      Done      ] - exits Set-Up
  96.         [ Last Date Paid ] - change last date paid
  97.         [ Mono/Color     ] - toggles between color and mono display
  98.         [ Printer/File   ] - toggles between output to printer or file
  99.  
  100.      [ DONE ] will activate changes, if any, and return to the Main Menu.
  101.  
  102.      [ LAST DATE PAID ] displays the last date a payment was made to CIS,
  103.         in YYYYMMDD format.  You must input this, obviously.  It would
  104.         be the last date a charge was made to your bank, your credit card,
  105.         or whatever.  It is initialized at "19900101" which is Jan 1, 1990.
  106.         The purpose of this is to be able to check (√) the end of week
  107.         totals which have been paid, giving you a quick take on your 
  108.         outstanding liability, which is then printed at the end of the
  109.         listing or display.
  110.  
  111.      [ MONO/COLOR ] simply toggles the display between color and mono.
  112.  
  113.      [ PRINTER/FILE ] lets you elect to have all printout go to the file
  114.         CISBILL.PRN ready for printing, rather than directly to a printer.
  115.  
  116.  
  117.      IV  FIELD DEFINITIONS
  118.  
  119.      [ Date ]:       MM DD of year printed in heading. (See Note 1)
  120.      [ Logon ]:      HH:MM Hours, Minutes of Logon time. (Detail only)
  121.      [ Min ]:        Elapsed minutes logged on.
  122.      [ $/Month ]:    $ Cost for the month (Weekly only).
  123.      [ $/Week ]:     $ Cost for that Week Ending. (Weekly only).
  124.      [ Cost ]:       $ Cost for session.  (Detail only).
  125.  
  126.                      The last item displayed (or printed) at the end of a
  127.                      week on a detail list will be "Other", which may 
  128.                      contain a $ value. This is the sum of all charges 
  129.                      not otherwise recorded, such as monthly fees, orders 
  130.                      from CIS, lagged daily billing, etc..  It is a 
  131.                      "catch all" for indeterminite items.
  132.  
  133.      [ √ ]:          This field will be checked if the item has been paid.
  134.  
  135.         The YEARLY TOTAL and CURRENT LIABILITY are printed at the end 
  136.         of the display or listing. 
  137.  
  138.      Note 1:  At year-end, the first weekly billing may contain data from
  139.                 the last few days of December of the previous year.  To
  140.                 keep these "wrong year" days in the right slot, they are
  141.                 assigned the new year, with a month of "00" rather than
  142.                 "12".
  143.  
  144.  
  145.                                                       CISBILL 2.03  Page  3
  146.  
  147.      V  FILES   
  148.   
  149.         Files needed to run CISBILL:
  150.                 CISBILL.COM - executable program
  151.                 BILLING.CAP - captured billing file (You create this)
  152.                               Once this has been read by CISBILL it can 
  153.                               be deleted.
  154.         Files created during CISBILL:
  155.                 CISBILL.CNF - Configuration file from Set Up
  156.                 CISBILL.Ynn - Cumulative Billing for year "nn"
  157.                               When the program detects a new year,
  158.                               a new Cumulative file is created.
  159.  
  160.         Files included for sample run only:
  161.                 CISBILL.Y92 - Sample cumulative billing file for 1992.
  162.                 CISBILL.Y91 - Sample cumulative billing file for 1991.
  163.  
  164.                 Delete these files BEFORE starting your own cumulative
  165.                 billing files !!
  166.  
  167.  
  168.                                                       CISBILL 2.03  Page  4
  169.  
  170.  
  171.      VI  ERROR MESSAGES
  172.  
  173.      There are two types of error messages which may occur - 1)-Limitation  
  174.      Errors and 2)-DOS Errors.  In all except one case, the program will end.  
  175.  
  176.      Limitation Error messages are:
  177.  
  178.         . Too much input to process...
  179.              Memory limitation - free up more memory.
  180.         . Too many records to process...
  181.              Memory limitation - free up more memory.
  182.         . File too big to process...
  183.              File selected is too big for memory.  Select another year or
  184.              quit.  Program does not automatically end here.
  185.         . No files to process...
  186.              No cum files available or created.  Get a BILLING.CAP file.
  187.         . Too many Cum files...
  188.              Over four years of cum files available.  Rename or delete.
  189.         . File has wrong format
  190.              Probably trying to read cum file created by previous version
  191.              of CISBILL.  Run the file thru CISBILRX to make it useable.
  192.         . No weekly data for this set of details
  193.              The BILLING.CAP file has details on it ahead of weekly
  194.              summary data.  All details prior to any weekly data will
  195.              be ignored.  The program will continue to process.
  196.  
  197.      DOS Error messages have the following format:
  198.  
  199.         [Program loc n] Dos error: xxxx....
  200.         Where:  n will be 1 thru 4
  201.                 xxxx.... will be a short DOS Error description
  202.  
  203.         if n = 1  The error occurred reading CISBILL.CNF
  204.                2  The error occurred reading CISBILL.Ynn
  205.                3  The error occurred writing CISBILL.CNF
  206.                4  The error occurred writing CISBILL.Ynn
  207.  
  208.      If you get any error and cannot determine what to do, see Page 6.
  209.  
  210.                                                       CISBILL 2.03   Page  5
  211.  
  212.      VII  CAPTURING A BILLING FILE   
  213.    
  214.      After logging on to CompuServe, GO BILL
  215.         The remainder of this shows the CompuServe responses and your input.
  216.  
  217.         ASSISTANCE               BILLING
  218.  
  219.         BILLING INFORMATION
  220.  
  221.          1 Current Rates
  222.          2 Review Your Charges
  223.          3 Electronic Funds Transfer (EFT)
  224.             (U.S. Addresses Only)
  225.          4 Billing Options Explained
  226.          5 Pricing Plans Explained
  227.          6 Changing Your Billing Address
  228.          7 Update Billing Information
  229.          8 Executive Service Option
  230.          9 General Billing Information
  231.  
  232.        !2 <----------------------------------------Select option 2 here
  233.  
  234.  
  235.         ASSISTANCE               CHARGES
  236.  
  237.  
  238.         CompuServe CHARGES
  239.          1 Explanation
  240.          2 Account Balance
  241.          3 Billing History
  242.  
  243.         USAGE DETAILS
  244.          4 Current activity
  245.          5 Previous activity
  246.          6 Mail Hardcopy ($)
  247.  
  248.         Enter Choice !5 <-----------------------------Select option 5 here
  249.                         <--------Just prior to responding, open a capture
  250.                                  file, BILLING.CAP, to record the rest of
  251.                                  the billing session.
  252.  
  253.  
  254.                                                       CISBILL 2.03   Page  6
  255.  
  256.         CompuServe CHARGES                    (New CIS format 9-92)
  257.  
  258.             Week Ending       Total
  259.             -----------       -----
  260.          1    04-Apr-92       $3.63
  261.          2    29-Mar-92      $64.27
  262.          3    21-Mar-92      $18.35
  263.          4    14-Mar-92       $7.24
  264.          5    07-Mar-92      $42.95
  265.          6    29-Feb-92      $29.46
  266.          7    22-Feb-92      $64.21
  267.          8    15-Feb-92       $5.76
  268.          9    08-Feb-92        $.21
  269.         10    01-Feb-92      -$5.83
  270.         11    25-Jan-92      $58.74
  271.         12    18-Jan-92      $34.66
  272.  
  273.         Enter choice !1 <-------------------------Enter week # choice here
  274.  
  275.         CompuServe CHARGES
  276.  
  277.                    BILLING DETAIL (Page 1 of 1)
  278.  
  279.         Date  Description           Node   Logon Min Amount
  280.        ------ --------------------- ------ ----- --- ------
  281.        04-Apr BASIC SERVICES        06ATO  11:35   2    .00
  282.               TOTAL FOR SESSION                         .00
  283.  
  284.        03-Apr BASIC SERVICES        14AGF  17:32   3    .00
  285.               EXTENDED SVC-2400                    2    .43
  286.               TOTAL FOR SESSION                         .43
  287.  
  288.        01-Apr BASIC SERVICES        07ATO  15:25   3    .00
  289.               EXTENDED SVC-2400                    8   1.71
  290.               TOTAL FOR SESSION                        1.71
  291.  
  292.               BASIC SERVICES        01ATA  16:54   1    .00
  293.               TOTAL FOR SESSION                         .00
  294.  
  295.         Last Page ! <---------------------------------Hit [ENTER] here
  296.  
  297.                                                       CISBILL 2.03   Page  7
  298.  
  299.         CompuServe CHARGES
  300.  
  301.             Week Ending       Total
  302.             -----------       -----
  303.          1    04-Apr-92       $3.63
  304.          2    28-Mar-92      $64.27
  305.          3    21-Mar-92      $18.35
  306.          4    14-Mar-92       $7.24
  307.          5    07-Mar-92      $42.95
  308.          6    29-Feb-92      $29.46
  309.          7    22-Feb-92      $64.21
  310.          8    15-Feb-92       $5.76
  311.          9    08-Feb-92        $.21
  312.         10    01-Feb-92      -$5.83
  313.         11    25-Jan-92      $58.74
  314.         12    18-Jan-92      $34.66
  315.  
  316.         Enter choice !2 <----------------------Enter another week here
  317.  
  318.   ____________________________________________________________________         
  319.    
  320.      Continue the above process until you have accessed all weeks you   
  321.      have not yet captured.  The first time, you should get ALL weeks.
  322.      When you are finished, close the capture file.
  323.  
  324.      Move the capture file to the directory where you plan to keep   
  325.      your cumulative billing files, and you are ready to run CISBILL.
  326.  
  327.         >> Revised Sep '92 to handle the new CIS billing format.
  328.            Also will work in 43 or 50 line mode (if you are already
  329.              in that mode).
  330.         >> Revised Jan '93 to solve problem of some erroneous files
  331.              created during start-up.
  332.  
  333.  
  334.  
  335.     VIII   SUPPORT
  336.  
  337.     ____________________________________________________________________
  338.    |                                                                    |
  339.    |    If you have problems or questions, contact the author:          |
  340.    |                       JN Goodale                                   |
  341.    |                       7826 Little John Court                       |
  342.    |                       Charlotte,  NC  28227                        |
  343.    |                                                                    |
  344.    |                       CIS ID 71116,302                             |
  345.    |                       Phone   (704)-537-0329 (Your nickel!)        |
  346.    |____________________________________________________________________|
  347.  
  348.    Version 2.02    Mar 1993
  349.  
  350.                                                        CISBILL 2.03  Page  8
  351.  
  352.      IX   SHAREWARE CONCEPT & OBUDSMAN STATEMENT
  353.  
  354.  
  355.         SHAREWARE CONCEPT
  356.         -----------------
  357.  
  358.         Shareware distribution gives users a chance to try software
  359.         before buying it.  If you try a Shareware program and continue
  360.         using it, you are expected to register.
  361.  
  362.         Shareware is a distribution method, not a type of software.  You
  363.         should find software that suits your needs and pocketbook, whether
  364.         it's commercial or Shareware.  The Shareware system makes fitting
  365.         your needs easier, because you can try before you buy.  And because
  366.         the overhead is low, prices are low also.  Shareware has the
  367.         ultimate money-back guarantee -- if you don't use the product,
  368.         you don't pay for it!
  369.  
  370.         OMBUDSMAN
  371.         ---------
  372.  
  373.  
  374.                Association Of Shareware Professionals Ombudsman
  375.  
  376.         This program is produced by a member of the Association of
  377.         Shareware Professionals (ASP).  ASP wants to make sure that the
  378.         shareware principle works for you.  If you are unable to resolve a
  379.         shareware-related problem with an ASP member by contacting the
  380.         member directly, ASP may be able to help.  The ASP Ombudsman can
  381.         help you resolve a dispute or problem with an ASP member, but does
  382.         not provide technical support for members' products.  Please write
  383.         to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send
  384.         a Compuserve message via E-Mail to ASP Ombudsman, 70007,3536
  385.  
  386.  
  387.                          .... End of CISBILL.DOC ....
  388.  
  389.  
  390.